home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 011 / menu104.arc / MENU.DOC < prev    next >
Encoding:
Text File  |  1986-06-23  |  9.1 KB  |  182 lines
  1.  
  2.                           About Hard Disk MenuMaster
  3.  
  4.            I. What is it?
  5.  
  6.               MenuMaster is a program which enables you to select an
  7.          application program from a menu, execute it, and then return
  8.          quickly.  It features online help, the ability to edit the
  9.          menus from within MenuMaster, and a certain level of password
  10.          protection for both editing the menus and executing
  11.          applications.
  12.  
  13.           II. Required files
  14.  
  15.               MENU.COM       The MenuMaster program itself
  16.               MENUCFG.CHN    Configuration program
  17.               MENU.DOC       This file
  18.               PASS.COM       Password generation program
  19.               MENU.DAT       Main data file
  20.               HELP.DAT       Help file (ordinary ASCII text with right
  21.                              margin of about 55)
  22.               NOTTHERE.DAT   Message displayed when a program is not
  23.                              found (ASCII text, right margin = 55)
  24.               PASSWD.DAT     If present, provides password protection
  25.                              for application programs
  26.               RUNMENU.BAT    Batch file from which MENU.COM is executed
  27.               $$$.BAT        Intermediate batch file (you might find
  28.                              this file if MenuMaster is interrupted
  29.                              abnormally.  Ignore it; it will be erased
  30.                              later)
  31.  
  32.  
  33.          III. Tricks on using MenuMaster
  34.  
  35.               For the most part, MenuMaster is self-explanatory, and
  36.          that which isn't obvious is probably explained in the help
  37.          file.  However, there are some semi-technical items which
  38.          might be confusing.  First, some background information:
  39.  
  40.               One of the most irritating things about some menu
  41.          programs is that they are slow.  Once you select WordStar,
  42.          for example, it takes a relatively long time for the WordStar
  43.          screen to appear.  Conversely, once you exit, it takes a
  44.          while for the menu screen to appear.
  45.  
  46.               Part of this problem might be a result of inefficient
  47.          programming, but a large part of the problem is because
  48.          these programs rely on DOS batch files to transfer control
  49.          to whatever program you choose and then back again, and that's
  50.          slow.  There is a way to speed things up, and that's what
  51.          MenuMaster does.  Some of the newer software packages such as
  52.          Microsoft Word and Lotus 1-2-3 version 2.0, as well as many others,
  53.          have the capability to run a subprogram, and then return to
  54.          the original program right where you left it.  That's what
  55.          MenuMaster does, and that is why it's fast.
  56.  
  57.               However, there is a tradeoff between speed and memory.
  58.          Since MenuMaster in effect loads another DOS in addition to
  59.          the memory that it already takes up, you lose about 60K by
  60.          using this method.  Thus, if you are running short of memory,
  61.          this method is unsatisfactory.  In addition, if you want to
  62.          execute a program which is memory-resident (such as SideKick)
  63.          from the menu, it has to be executed at the same level as
  64.          MenuMaster.
  65.  
  66.               For these two reasons, there is a batch file execution
  67.          mode for a menu item.  If your application falls into one of
  68.          the above two categories, you should answer 'Y' to this
  69.          question.  A totally batch-driven menu system is possible
  70.          this way, which can be useful for those with limited system
  71.          memory.
  72.  
  73.          To install MenuMaster, simply specify the RUNMENU command
  74.          at the end of your AUTOEXEC.BAT file.  That automatically
  75.          invokes MenuMaster every time you turn your computer on.
  76.  
  77.               At this time, there is no way to specify command line
  78.          parameters for a menu item.  Thus, if you need parameters,
  79.          you must write a short batch file which contains them.  For
  80.          instance, if you have a dBASE III program called main.prg, to
  81.          execute it you would type 'dbase main'.  However, you would
  82.          have to specify a batch file (dbmain.bat for example) which
  83.          contained the line 'dbase main' if you want to use it with
  84.          MenuMaster.
  85.  
  86.          If you want a menu option to be one where you temporarily
  87.          exit to DOS and want to have a fast return, simply specify
  88.          COMMAND.COM as the executable filename and you will get a
  89.          DOS prompt again.  To return to the menu, simply type
  90.          EXIT [Return] and you will get the menu screen back again.
  91.  
  92.          The menus are kept in memory at all times.  However, for
  93.          MenuMaster to give enough memory back to the application
  94.          it's executing, I had to restrict the amount of memory
  95.          that MenuMaster uses.  Thus, there is a limit on the number
  96.          of Main Menu Options.  This number is configurable using the
  97.          /C option.  This does not affect the number of submenu options
  98.          -- you can have up to 20 menu options per main menu option.
  99.  
  100.          If you receive the error message 'Run-time error FF' while
  101.          MenuMaster is loading, that means that your data file contains
  102.          too many main menu items to be loaded into memory.  If this
  103.          happens, type 'menu /c' to change the number of main menus
  104.          to the number you need.  See section V., Configuration, below.
  105.  
  106.          IV.  Passwords
  107.  
  108.          Run PASS.COM to create the password file PASSWD.DAT.  The
  109.          file it creates is marked as read only the first time you
  110.          run MenuMaster, so if you run PASS.COM when there is
  111.          already a PASSWD.DAT, the PASS program will abort.  Use
  112.          any public domain program or DOS 3.1 ATTRIB command to
  113.          change the file attribute to writeable.
  114.  
  115.          The password file can have up to 255 separate passwords, but
  116.          one password is reserved for the F2 (Edit menu item) command
  117.          in MenuMaster.  That is, if there is a password file, that
  118.          password will be the one to enter if a person wants to edit
  119.          the menus.  You can have an application protected by this
  120.          password, but when you try to execute the application,
  121.          the program will prompt 'Edit password: ' instead of 'Enter
  122.          password: '.
  123.  
  124.          This password number is one by default, but is configurable.
  125.  
  126.          If there is no password file, no passwords ever need be
  127.          entered.
  128.  
  129.          If a menu item is password protected, when the person tries
  130.          to edit that menu item's data, he or she will be asked to
  131.          enter two passwords -- one to Edit the menus in the first
  132.          place, and one to access that menu item's data.
  133.  
  134.          V. Configuration
  135.  
  136.          You can configure the system colors, the maximum amount of
  137.          main menus, whether or not your screen flickers, and any of
  138.          the system filenames, if you wish.  All you have to do is
  139.          enter 'menu /c' instead of 'menu' at the DOS prompt.  The
  140.          file MENUCFG.CHN file is required in the same directory
  141.          for you to be able to configure the program, however.  If it
  142.          is missing, then you will get an error message to that effect.
  143.  
  144.          The file MENUCFG.CHN is not needed once you have completed the
  145.          configuration process.
  146.  
  147.          The configuration program is mostly self explanatory.  However,
  148.          one aspect might be somewhat confusing.  In the colors section,
  149.          you enter the foreground color number, a comma, and then the
  150.          background color number.  If the foreground color is one digit,
  151.          you have to enter the comma; otherwise it is shown on the screen
  152.          for you.
  153.  
  154.          If you make a mistake and the backspace key doesn't seem to work,
  155.          don't worry.  Just continue on to the end; you will be asked to
  156.          confirm your choices at the end.  Simply answer 'N' and enter
  157.          the value again.
  158.  
  159.          With all the configuration options, you can simply press return
  160.          to keep all the default values shown on the screen.
  161.  
  162.          When you indicate that your configuration options are OK, the
  163.          new values that you specified will be written and saved to the
  164.          MenuMaster program.  Run MenuMaster again to see the changed
  165.          values!
  166.  
  167.          I can't think of anything else...  If you have any questions,
  168.          contact me on Gene Plantz' BBS in Chicago, under ID1327.
  169.  
  170.          This program has been released into the public domain for
  171.          commercial and non-commercial use, and may be used, distributed
  172.          or destroyed by anyone as they may please.  This is true as long
  173.          as no one sells this program or otherwise distributes it for
  174.          purposes of financial gain.  The author provides no warranty,
  175.          either express or implied, and is in no way responsible for
  176.          the operation of this program.  So there!  (I have always wanted
  177.          to write something like this!)
  178.  
  179.          Enjoy!!!      Bill Bliss
  180.                        627 Dartmouth Place
  181.                        Evanston, IL 60201
  182.